新增 AI Agent 聊天模块，包括聊天界面、服务层、数据存储和多语言支持

将 Agent API 请求路由到 runtime/gmApi 通道，通过 @PermissionVerify.API
装饰器实现权限验证，脚本首次调用时弹窗确认，防止未授权消耗 API Token。

- 新增 OPFS 文件浏览器页面，支持目录浏览、文件预览和删除操作
- 默认进入 agents/ 目录，支持面包屑导航到根目录
- 支持在 conversation.create 时注册工具，简化多轮对话的工具传递
- 添加 8 种语言的 i18n 翻译

- 修复 callLLM 提前转发 done 事件导致客户端过早 resolve 的问题
- 修复 WindowMessage.connect 未使用 "*" targetOrigin 导致沙箱消息被丢弃
- 修复 tool calling 循环中 assistant 消息缺少 tool_calls 字段
- 支持 OpenAI 和 Anthropic 格式的 tool_calls 消息构建
- UI 合并 tool 结果到 assistant 的 ToolCallBlock 展示，过滤 tool/system 消息
- 提取 buildInstance 函数解决装饰器 this 绑定问题，使用 uuidv4 生成 ID

- ChatMessage 类型新增 usage/durationMs/firstTokenMs 字段
- Service Worker 测量 LLM 调用总耗时并通过 done 事件返回
- UI 层捕获首 token 延迟和 token 用量，持久化到消息中
- 新增 MessageToolbar 组件：左侧操作按钮(复制/重新回答/删除)，右侧元数据信息(token用量/耗时/TTFT/工具调用数)
- 流式期间显示实时计时动画，完成后切换为最终数据
- 删除操作支持二次确认
- 新增 deleteMessages 批量删除辅助函数
- 添加 i18n 多语言支持(8个locale)

- 新增 CATTool 元数据解析、存储、注册和执行完整链路
- 新增 CAT.agent.tools GM API（install/remove/list/call）
- 修复 CATTool 沙箱执行时 args 未定义的问题：使用 compileScriptCodeByResource 包裹代码以启用 with 上下文绑定
- 优化 Agent Chat UI 组件样式

将 App.tsx (~1130行) 按职责拆分为：
- utils.ts: 纯工具函数和常量
- hooks.tsx: useInstallData() 自定义 hook
- components/CATToolInstallView.tsx: CATTool 安装视图
- components/ScriptInstallView.tsx: UserScript/Subscribe 安装视图
- App.tsx: 精简为路由分发 (~57行)

新增 example/agents/tools/ 目录：
- hello_world.js: 最简 CATTool 示例
- text_processor.js: 多参数和 enum 类型
- json_formatter.js: JSON 处理和错误处理
- weather_query.js: GM_xmlhttpRequest 网络请求
- use_cattool.js: 通过脚本 API 安装和调用 CATTool
- README.md: 格式说明和测试方法

- 修复历史消息未携带 toolCalls 字段导致多轮 tool calling 上下文丢失
- 添加 OpenAI 流式 API 错误响应处理
- 添加 /new 命令和 clearMessages 接口用于清空对话上下文
- UI 发送消息时正确传递 toolCallId 和 toolCalls

- 删除独立的 handleChat，UI 和 Sandbox 统一走 conversationChat 通道
- 持久化责任从 UI 移交到 SW，简化前端逻辑
- 字段命名统一：createdAt/updatedAt → createtime/updatetime
- 支持 UI 动态切换 modelId
- 大幅补充 Agent 相关测试（流式解析、tool calling 循环、CATTool 边界等）

- 对话实例支持 / 命令拦截机制，内置 /new 命令清空对话
- 脚本可通过 commands 选项注册自定义命令并覆盖内置命令
- 修复会话列表删除确认弹框因鼠标移开导致隐藏的问题
- 会话 ID 同步到 URL 参数，刷新页面保持当前会话选中
- 新增命令机制 8 个单元测试

- CATTool 安装改为打开安装页面确认，支持脚本来源追踪和更新提示
- CATToolRepo 索引/数据分离（tools.json 索引 + data/<id>.json 完整记录）
- CATTool UUID 由 SW 统一生成，通过全局映射支持 GM API 权限验证
- AgentModelConfig 从 SystemConfig 迁移到独立的 AgentModelRepo
- AgentModelRepo.getDefaultModelId 使用 chrome.storage.local 直接存取
- cancelCATToolInstall 统一为 try/finally 模式
- openCATToolInstallPage 增加 tab.id 空值检查

实现 Agent 框架的 DOM 操作 API，支持两种模式：
- 默认模式：通过 chrome.scripting.executeScript 操作
- trusted 模式：通过 chrome.debugger CDP 实现真实用户输入

新增 8 个 Agent 工具：dom_list_tabs, dom_navigate, dom_read_page,
dom_screenshot, dom_click, dom_fill, dom_scroll, dom_wait_for

readPage 支持 summary/detail 分层读取，控制上下文大小；
操作后自动返回 ActionResult（跳转/新 tab/dialog 检测）；
debugger 权限放在 optional_permissions 动态申请。

- 新增 Skill 类型定义（SkillSummary, SkillRecord, SkillApiRequest 等）
- SKILL.md 解析器（YAML frontmatter + markdown body）
- SkillRepo OPFS 存储（registry + scripts + references）
- AgentService 集成：loadSkills, installSkill, resolveSkills
- 2 个 meta-tool：execute_skill_tool, read_reference
- GM API: CAT.agent.skills（list/get/install/remove）
- UI: ChatInput 增加 Skills 选择器

- agent-fixtures.ts: Mock LLM 基础设施（context.route 拦截 + OpenAI SSE 响应）
- agent-conversation.spec.ts: 基础对话、Tool Calling、多轮上下文保持
- agent-cattool.spec.ts: CATTool 安装/调用/删除、CATTool + 对话联动

resolveSkills 不再将完整 SKILL.md 正文和 CATTool schema 一次性注入 system message，
改为三层渐进加载：1) 摘要列表 2) load_skill 按需获取 prompt 3) execute_skill_tool/read_reference 按需执行。
execute_skill_tool 新增 skill_name 参数确定工具作用域，CATTool 脚本改为执行时按需加载。
新增 14 个 Skill 系统单元测试。

ephemeral 模式下会话不持久化到 OPFS、不加载内置工具和 Skills，
工具完全由脚本提供，消息历史由脚本端内存管理。
SW 端无状态处理，仅解析 model 配置调用 LLM。

…rompts

实现完整的 MCP (Model Context Protocol) 客户端:
- MCPClient: JSON-RPC 2.0 over HTTP POST，Session ID 管理，认证头
- MCPService: 连接池管理，懒连接，MCP 工具自动注册到 ToolRegistry
- MCPServerRepo: chrome.storage 持久化服务器配置
- GM API: CAT.agent.mcp（SW + Content 双侧），权限验证
- UI: AgentMcp 页面 — 服务器 CRUD、启用/禁用、测试连接
- 单元测试覆盖 MCPClient、MCPToolExecutor、MCPService

agent_model:__default__ 存储的是默认模型 ID（字符串），被 find() 当作
AgentModelConfig 返回，导致 UI 访问 model.apiKey.length 时报 TypeError。

- 解析 SSE delta 中的 reasoning_content 字段，发出 thinking_delta 事件（兼容 deepseek/o-series）
- 将 usage 检查移到 choices 处理之后，修复最后一个 chunk 同时包含 tool_call 增量和 usage 时丢失数据的问题
- Service Worker callLLM() 收集 thinking 内容并持久化到 assistant 消息
- 修复 vitest.config.ts 中重复 exclude 导致 e2e 测试被误执行的问题

- 注册 installSkill/removeSkill 消息处理到 AgentService.init()
- AgentClient 新增 installSkill/removeSkill 方法
- 新建 AgentSkills.tsx：Skill 列表卡片、详情编辑弹窗、URL/粘贴安装弹窗
- 替换 /agent/skills 路由为实际管理页面
- 8 个语言文件新增 19 个 agent_skills_* 翻译 key
- 新增 9 个单元测试覆盖安装/卸载/消息注册核心流程

新增 parseSkillZip 解析 ZIP 包（SKILL.md + tools/*.js + references/*），
UI 增加 ZIP 上传 Tab，支持嵌套目录结构，含完整单元测试和端到端集成测试。

chrome.permissions.request() 在 MV3 Service Worker 中无法调用（需要用户手势），
改为打开 confirm.html 确认页面，用户点击授权按钮后通过 runtime.sendMessage 通知 SW。

将三层 meta-tool 设计（load_skill → execute_skill_tool → CATTool）简化为两层：
- load_skill 调用时动态注册该 skill 的 CATTool 为独立工具（{skill}__{tool} 格式）
- callLLMWithToolLoop 每轮重新获取工具定义以发现新注册的工具
- 对话结束后清理动态注册的工具和 meta-tools
- 新增 prefixToolDefinition 辅助函数

- 新增 ServerDetailDrawer：展示 Tools/Resources/Prompts 三大能力
- 卡片操作栏增加"详情"按钮，通过 MCPClient 直接查询服务器能力
- 测试连接按钮增加 loading 状态
- 编辑 Modal 底部增加测试连接按钮，填完表单可直接测试
- 补充 8 个 locale 文件的 i18n key

将 2534 行的 AgentService 上帝对象拆分为 11 个专用服务
（AgentService 472 行，-81%），并重组 Agent 代码目录。

提取的服务：
- SkillService: ZIP 安装/刷新/解析
- AgentTaskService: 定时任务 CRUD + 执行
- AgentModelService: 模型配置与选择
- AgentOPFSService: OPFS 文件访问
- SubAgentService: 子代理会话管理
- BackgroundSessionManager: 后台会话状态
- CompactService: 对话压缩摘要
- LLMClient: LLM 调用封装
- ToolLoopOrchestrator: 工具循环编排
- ChatService: 对话处理（ephemeral/compact/persistent）
- resolveAttachments utility 抽取

目录重组：
- src/app/service/agent/core/          跨上下文共享核心
- src/app/service/agent/service_worker/ SW 端有状态服务
- 清理文件 agent 前缀（agent_dom.ts → dom.ts 等）

AgentTaskRun 原本存在 chrome.storage.local（键前缀 agent_task_run:），
存在几个问题：配额压力、listRuns 全表扫描、缓存常驻内存。

改为 OPFS 后：
- 存储路径：agents/task_runs/{taskId}.json（内含 run[] 降序）
- listRuns O(全表) → O(单文件 parse)
- 环形缓冲：每任务保留最近 100 条（append 时自动裁剪）
- Agent 体系存储后端统一到 OPFS

改动：
- agent_task.ts: AgentTaskRunRepo extends Repo → extends OPFSRepo
- task_scheduler.ts: updateRun 签名加 taskId 参数
- 测试：添加 OPFS mock + 2 个新用例（环形缓冲 / 更新不存在 id）

Agent 功能尚未发布，无需考虑旧数据迁移。
Typecheck 0 错误，1736 测试全绿（+2 新用例）

AgentChatRepo 是 OPFS 的无状态包装，原本通过 AgentService._repo
配合 setter 同步给 4 个子服务 (CompactService/LLMClient/
ToolLoopOrchestrator/ChatService)，新增子服务容易遗漏同步。

改为模块级单例 agentChatRepo，子服务直接 import 使用，测试用
vi.hoisted + vi.mock 替换整个模块，彻底消除 setter 同步仪式。

- SessionToolRegistry 组合模式：per-session 工具注册隔离，消除并发会话工具覆盖
- excludeTools 后端强校验 + 未知 sub-agent type 抛错
- ChatStreamEvent 分类重组：LLMStreamEvent → ForwardableEvent 层次化，
  消除递归 sub_agent_event 改为 subAgent? 扁平标识
- Sub-agent context OPFS 持久化，resume 时内存优先、OPFS 回退
- 清理 AgentService 测试兼容性代理 getter/setter（~45 行）
- 移除 ChatService 未使用的 compactService 字段
- 提取 OPFS mock 到共享 test-helpers

- 子代理使用独立 childRegistry 替代共享父 sessionRegistry，避免工具泄漏
- system prompt 增加防注入/防数据外泄/数据指令分离安全规则
- get_tab_content 增加 URL 策略校验（assertDomUrlAllowed）
- researcher 子代理移除 execute_script 工具
- Anthropic provider 对畸形 toolCall arguments 降级为空对象
- 子代理超时后追加提示信息，区分用户取消与超时
- tool loop 移除 withRetry 包装，重试逻辑下沉到 llm_client
- 修正 tool call budget 描述为 rounds 而非单次调用

- 新增 navigate_tab 工具：导航已有标签页到新 URL，支持等待加载完成
- researcher 子代理增加页面只读能力（get_tab_content/open_tab/list_tabs/close_tab/navigate_tab），但不允许 DOM 交互
- 移除 get_task 和 delete_task 工具，list_tasks 改为返回完整任务信息
- 页面交互指南仅在同时拥有 get_tab_content 和 execute_script 时显示

- 提取 TokenUsage 公共类型，消除 6 处内联重复
- AgentTask 改为判别联合类型（InternalAgentTask | EventAgentTask）
- zhipu 注册为正式 Provider，消除 llm_client 硬编码分支
- handleConversationChat 拆分为 5 个职责单一的子方法
- Provider 层提取 content_utils.ts 公共逻辑（SSE 读取、内容块转换、附件 ID 生成）
- agentChatRepo 统一构造函数注入（LLMClient/CompactService/ToolLoop/ChatService）
- skill_service 提取 fetchSkillResources 共享方法
- web_search 搜索方法模板抽取（fetchAndExtract）
- 统一工具参数校验辅助函数（param_utils.ts）
- 提取 UA/超时常量，tab_tools 复用 stripHtmlTags
- 删除目录重组遗留的旧文件
- 修复 e2e agent-fixtures 缺失 expect 导出

- 简化 agent-chat.spec.ts：移除不可靠的 LLM mock 测试，保留基础 UI 验证
- 修复 agent-fixtures.ts 缺失的 expect 导出
- 提交 e2e/utils.ts 的 Agent 辅助函数（openAgentChatPage 等）
- 删除 debug-provider 调试文件

- pre-commit：每次提交前运行 typecheck + eslint --fix
- pre-push：仅推送到 main/release 时运行测试
- 修正原 pre-commit 实际为 pre-push 逻辑的问题
- 移除 lint-staged（直接全量 lint-fix）

agent 工具新增 tab_id 可选参数，父代理可将已打开的标签页传递给子代理，
子代理会直接使用该标签页而非重复打开新页面。

pre-commit：lint + main/release/* 分支跑 test:ci
删除 pre-push hook